Getting Started with PrizmDoc > Installation > Self-Hosted > Installing PrizmDoc Server > Single-Server > Installing on Linux > Installing on a Headless Environment |
Use the following steps to install PrizmDoc in a Linux headless environment:
The '#' sign in command examples denotes running the command as the root user. All command lines preceded by the '>' sign are the example output of that command, where applicable.
Before you download PrizmDoc, note that packages are only available for 64-bit systems. |
Before downloading PrizmDoc, you will need to purchase a license key or request a Trial Evaluation by filling out the following form: www.accusoft.com/products/prizm-content-connect-pcc/get-self-hosted/.
Once you have purchased a license key or filled out the form for a Trial Evaluation, you can download PrizmDoc by:
OR
Red Hat, Fedora, CentOS, and Older Linux Distributions
Example Copy Codewget http://products.accusoft.com/PrizmDoc/11.0/prizmdoc_client_full_<version>.x86_64.rpm.tar.gz
Debian and Ubuntu Linux Distributions
Example Copy Codewget http://products.accusoft.com/PrizmDoc/11.0/prizmdoc_full_<version>.amd64.deb.tar.gz
Generic .tar.gz Distribution
Example Copy Codewget http://products.accusoft.com/PrizmDoc/11.0/prizmdoc_full_<version>v.x86_64.tar.gz
For license, fill out the form at http://www.accusoft.com/products/prizm-content-connect-pcc/get-self-hosted/ or http://www.accusoft.com/contact/.
Open a command line and change to the location where you downloaded the tarball. Use the following command line examples appropriate for your distribution to:
The following example is for Red Hat, Fedora, CentOS, and older Linux distributions:
Example |
Copy Code
|
---|---|
# tar –xzvf prizmcc_<version>_rpm.tar.gz # cd prizmcc_<version>_rpm # yum install –nogpgcheck *.rpm |
Note: For CentOS 5.x, the following additional dependencies must be installed prior to PrizmDoc RPM installation:
|
The following example is for Debian (Ubuntu) Linux distributions:
Example |
Copy Code
|
---|---|
# tar –xzvf prizmcc_<version>_deb.tar.gz
# cd prizmcc_<version>_deb
# sudo dpkg –i *.deb
# sudo apt-get –f install
|
We also provide a generic .tar.gz package. You will need to install the dependencies described in the Requirements section. Once the dependencies are installed, you can install the .tar.gz with the following commands as root:
Example |
Copy Code
|
---|---|
# tar -xzvf prizmcc_*.tar.gz # cd prizmcc* # tar -xzvf prizm-contentconnect*.tar.gz # tar -xzvf prizm-services*.tar.g # tar -xzvf prizm-pas*.tar.gz # cp -R prizm /usr/share/ |
Example Copy Code # cd /usr/share/prizm # sh ./setup.sh
The setup script will now invoke a text-based wizard for licensing:
To install a license at the end of the evaluation period, (for example, a deployment license), run the following command:
If you already have a license for PrizmDoc, you can use one of the other licensing options, detailed in the Command Line Mode Licensing section of the help.
Example Copy Code# ./setup.sh eval get youremail@example.com
Example Copy Code # cat ./conf/proxyserver_jar.properties | grep license_key > license_key=<long string>
However, if you have an error in the log stating that it cannot connect to the Office converter Worker-1 instance, then you must continue to the 'Step 4 - Running an X Virtual Framebuffer' section below.
A full version of the X11 server is not required to run PrizmDoc. However, the minimum requirement is the X Virtual Framebuffer Server, which you can install and run separately from an entire X11 instance.
Debian/Ubuntu
Example Copy Code# sudo apt-get install xvfb
Red Hat / CentOS
Example Copy Code # yum install xorg-x11-server-Xvfb
Example Copy Code# Xvfb :20 >/dev/null 2>&1 & # export DISPLAY=:20
Example Copy Code # /usr/share/prizm/scripts/pccis.sh startRequired:
The X Virtual Framebuffer Server must be running any time that the PrizmDoc Server is running.
Suggested:
It may be appropriate to create a script that will start the Xvfb service and PrizmDoc Server (the 3 lines above) to execute whenever the machine is restarted.
It may take several minutes for PrizmDoc Server to become completely healthy. The page will auto-refresh as PrizmDoc Server come online.
By default /usr/share/prizm/pccis/servicehost/host.config contains the following limitation:
/usr/share/prizm/pccis/servicehost/host.config "httpRuntime": { ... "maxRequestLength": 50000000 }
which limits maximum document file size to 50Mb, and so PCCIS will return HTTP-500 when larger files are uploaded to the service.
If you are dealing with larger files it will necessary to change the "maxRequestLength" option to a more appropriate value.